# Advanced Fuel System by vLaati

A realistic and advanced fuel mod for GTA V.

This mod adds a proper fuel system to every vehicle in the game. Fuel now runs out based on how you drive, and you must visit gas stations to refuel.

## Features

- **Realistic Fuel Consumption**
  - Fuel usage depends on speed, acceleration, and idling
  - Different vehicle types use different amounts of fuel (sports cars use more, motorcycles use less)
  - Trucks and muscle cars consume fuel faster

- **Engine Behavior**
  - Engine automatically turns off when fuel reaches 0
  - Vehicle becomes undriveable until refueled
  - Engine sputters and stalls when fuel is very low (below 5%)

- **Gas Stations**
  - 23 real GTA V gas station locations
  - Multiple working pumps at each station (no more "only one spot works")
  - You can park near any pump to refuel

- **Refueling**
  - Hold **E** to refuel (costs money by default)
  - Refueling takes time — not instant
  - Engine turns off automatically while refueling

- **Clean UI**
  - Fuel bar and percentage shown on screen
  - Color changes as fuel gets low (green → yellow → red)
  - Station name and instructions appear when near a pump

- **Easy Configuration**
  - Fully customizable through an INI file
  - Change fuel usage rates, tank sizes, prices, and more

## Requirements

- Grand Theft Auto V (latest version)
- [Script Hook V](http://www.dev-c.com/gtav/scripthookv/)
- [Script Hook V .NET](https://github.com/alloc8or/reloaded-iii/releases) (ScriptHookVDotNet3)

## Installation

1. Download the mod files
2. Copy `AdvancedFuelSystem.dll` into your game's `scripts` folder
3. Copy `AdvancedFuelSystem.ini` into the same `scripts` folder (optional - will be created automatically)
4. Start the game

The mod starts automatically when the game loads. No menu or activation needed.

## Controls

- **E** - Hold to refuel (when near a gas pump)
- **F7** - Toggle the fuel UI on/off

## How to Use

1. Drive normally — fuel will slowly decrease
2. When fuel gets low, the game will warn you
3. Go to any gas station (green jerry can icons on the map)
4. Park near any fuel pump
5. Hold the **E** key to start refueling
6. Release **E** when done

**Tip:** The fuel bar is in the top-right corner of the screen.

## Configuration (AdvancedFuelSystem.ini)

You can edit the `AdvancedFuelSystem.ini` file in the `scripts` folder to change:

- How fast fuel is used
- Tank size for different vehicle types
- Fuel price
- Refuel speed
- UI position and size
- Keybinds

**To reset to default settings:** Just delete the INI file. A new one with default values will be created the next time you load the game.

## Tips

- Fuel lasts much longer than in older versions of this mod
- Expensive cars (sports, super, muscle) use more fuel
- Motorcycles are the most fuel efficient
- You can turn off the money cost in the config file
- The UI only shows when you're in a vehicle

## Notes

- This mod only affects vehicles the player drives
- It does not affect NPC traffic
- Works with story mode and GTA Online (in single player sessions)

---

**Created by vlaati**

Enjoy the mod! If you have any problems, feel free to leave a comment on the download page.